home *** CD-ROM | disk | FTP | other *** search
/ The Supreme Court / The Supreme Court.iso / mac / MacUtils / Conversion / uuparser1.71a / UUParser v1.71a / UUParser v1.71a.rsrc / TEXT_300.txt < prev    next >
Text File  |  1994-02-28  |  19KB  |  517 lines
  1.     
  2.  
  3.  
  4.  
  5.  
  6.             UUParser
  7.     an Internet file extraction utility for the Macintosh‚Ñ¢
  8.  
  9.  
  10. By John S. Lee, ¬© 1993,1994.
  11.  
  12. UUParser takes out the header information in files that have been
  13. uuencoded and uploaded to a newsgroup.
  14.  
  15. UUParser also allows you to "S"ave multiple articles from newsgroups,
  16. normally in several parts, and re-assembles them as one contiguous file
  17. ready for uudecoding.
  18.  
  19. UUParser can also automatically uudecode files for you.
  20.  
  21.  
  22.  
  23. Directory    
  24.  
  25. FEATURES - What's so good about UUParser? 
  26. INSTRUCTIONS - Getting UUParser set up for the first session.
  27.     Drag & Drop - Stuff you can do from the desktop.
  28. FILE MANIPULATION (FILE MENU) - How to UUParse.
  29.     UUParse/UUParse Several - Get a file, parse it!
  30.     Join Files - Join several files together as one large file.
  31.     Split File - Take a file and automatically split it.
  32.     UUDecode - uudecode a file.
  33.     UUEncode - uuencode a file.
  34. PREFERENCES (in the FILE MENU) - Make UUParser work for YOU.
  35.       Delete  - get rid of the file after it has been parsed.
  36.       Show Status - how much farhter before parsing is done?
  37.       Scan - Find the non-ascii nasties in a file.
  38.       Set Default Encoding - Here's how I want to encode a file.
  39.           PC - Use this for MS-DOS machines.
  40.           UNIX - The standard for posting on UNIX systems.
  41.           MAC - Need I say more?  Long filenames; what more do U need?
  42.           AIFF->ULAW - Convert aiff to Sun or NeXT format.
  43.           AIFF->Linear - Convert AIFF to Macintosh Linear format.
  44. EDIT FILE TYPES (in the EDIT MENU) - How to make UUParser "SMART"
  45. SPECIAL - Well isn't it?
  46.   Scan Only - Are there any non-ascci nasties in this file?
  47.   Auto UUDecode - After parsing, decode it and save it.
  48.   Set Target Directory - Where do you want to put your parsed files?
  49. REGISTRATION - If you use this program you MUST do this!
  50. CREDIT - To each his/her proper due!
  51. COLD MOD STUFF - A program is NEVER finished, it just
  52.                                EVOLVES.
  53. UUParser Internals & Notes - Do's, how's, why's, where's, dont's!
  54. Upgrades - I'm registered, where's my upgrade?!?
  55. Future Additions - What's gonna happen with UUParser in the next rev.?
  56. Hints - You mean, I can do that?
  57.  
  58.  
  59.    
  60.  
  61. Features    
  62.  
  63. ‚Ä¢ Automatic stripping of header information from files "S"aved
  64.    from a usenet newsgroup.
  65. ‚Ä¢ "Smart" uudecoding.  Fully user configurable.
  66. ‚Ä¢ uuencoding of AIFF (sound) files is now supported.
  67. ‚Ä¢ uuencoding in PC, UNIX, and AIFF formats.
  68. ‚Ä¢ User control over output file location.
  69. ‚Ä¢ Join multiple text files for UUParsing & automatic decoding, from
  70.    the menu OR the desktop.
  71. ‚Ä¢ Split any text file into multiple parts using the Split File function.
  72. ‚Ä¢ User configurable preferences.
  73. ‚Ä¢ Automatic scan of text files for anomalies.
  74. ‚Ä¢ Drag & Drop UUParsing supported via System 7.
  75. ‚Ä¢ Parsing/uudecoding/encoding occurs in the background.
  76. ‚Ä¢ Decodes/encodes/parses ANY SIZE FILE, regardless of memory.
  77. ‚Ä¢ The FASTEST uudecoding/encoding available for the Mac!
  78.  
  79.  
  80. Instructions    
  81.  
  82. Double-click on the application "UUParser"
  83.  
  84. (Note: If this is the first time you have used UUParser or 
  85.  are upgrading from a previous version you MUST set the 
  86. Target Directory!)
  87.  
  88. Select Set Target Directory from the Special menu so that
  89. UUParser knows where to put the output files.  This directory
  90. will also be used as the defualt for placement of decoded files.
  91. (see note above)
  92.  
  93. Select Auto UUDecode from the SPECIAL menu if you want to 
  94. automatically uudecode the parsed files.
  95.  
  96. Select UUParse or UUParse Several from the FILE menu.
  97.  
  98. Select the file you want to parse.
  99.  
  100. Choose another file or CANCEL (cmd .).
  101.  
  102. If you did not choose to Auto UUdecode your file you can 
  103. uudecode it using UUDecode from the FILE menu.
  104.  
  105. DRAG & DROP
  106. Select the documents you want to parse and drag them to the 
  107. UUParser  icon.  
  108. The application will start and the files will be parsed, decoded
  109. and placed in you target directory.
  110.  
  111. *Holding down the CMD key will automatically join the files!
  112.  
  113.  
  114. File Manipulation    
  115.  
  116.  
  117. UUParse/UUParse Several
  118. Opens files(s) for parsing.
  119.  
  120. Join Files
  121. Takes any number of files parses them and concatentates them.
  122. Choose the first file to join.  Subsequent selections are attached
  123. to the first file.  Parse the file and it's ready to uudecode.
  124.  
  125. Split File
  126. Takes a file and seperates it into sections of 900 lines each.
  127. Each can then be uploaded to a newsgroup in succession for
  128. someone to retrieve and re-assemble. This feature AUTOMATICALLY
  129. installs BEGIN/END cut lines in each of the files it generates.
  130.  
  131. UUDecode (smart)
  132. uudecodes file(s) that has been parsed.  Before decoding it 
  133. determines, by parameters you set (see Set File Types), 
  134. what type of file type it should be set to.  Once decoded it
  135. appears on the desktop as a document of the application 
  136. you specify.
  137.  
  138. UUEncode (configurable)
  139. uuencodes a file. UUParser can encode items in PC/MS-DOS,
  140. UNIX, AIFF->Linear (for sound), and AIFF->ULAW (for sound).
  141. UUParser will also give create a filename in the proper format
  142. for the encoding scheme chosen (i.e. if you chose MS-DOS the filename
  143. will be 8chars.ext.; UNIX will have all whitespace replaced by "_").
  144. The default scheme is UNIX, but you can change it from the MENU 
  145. Encode Options, or in the Preferences dialog box.   If Mac is chosen
  146. the scheme will use the UNIX encoding, but use the Macintosh
  147. conventions for the filename.
  148.  
  149.  
  150. Edit File Types    
  151.  
  152.  
  153. This function allows you to select a string that UUParser will
  154. use to set the file's type and creator (so that they are recognized
  155. by the Finder and your favorite application(s).  You select it
  156. from the Edit menu.  You enter the file suffix along with the 
  157. file type and creator associated with the file.  You are allowed
  158. 10 entries.  Many of them are already set up for you.
  159. (example  file.jpg:             file suffix: .jpg
  160.                                        file type       : JIFF
  161.                                        file creator  : JVWR
  162.  
  163.    This sample shows that any file that is decoded that has the 
  164.   ".jpg" extension in the filename will be set to the JPEGViewer
  165.    file type.  This allows JPEGView to open the file directly from the
  166.    finder without first "fixing" the file.)
  167.  
  168. The file suffix can be in upper/lower/mixed case.  UUParser will
  169. correctly set the type/creator!
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Preferences    
  178.  
  179. READ FILE IN BLOCKS (on/off) [Default - ON]
  180.  Read a file using the availble memory.  Use this option if
  181.  you are trying to parse a file that is larger than the available
  182.  memory (i.e a 900k file, and UUParser has a 640k partition).
  183.  
  184. DELETE SOURCE FILE (on/off) [Default - OFF]
  185.  Delete the soruce file once the scanning/parsing process
  186.  has been done.
  187.  
  188. DELETE INTERMEDIATE FILE (on/off) [Default - OFF]
  189.  Delete the intermediate ( xxx filename.ext)
  190.  file once the scanning/parsing process has been done.
  191.  
  192. SHOW STATUS (on/off) [Default - ON]
  193.  Show progess indicator, just to let you know how much of the 
  194.  file has been scanned/parsed.
  195.  
  196. SCAN before parsing (on/off) [Default - ON]
  197.  Check each character in the file to amke sure it is an ascii "printable" 
  198.  character.  Prevents bad data (from a bad transmission or poor
  199.  line conditions) from being interpreted by the uudecoding function.
  200.  
  201. Set Default Encoding:
  202. PC - Uses pc-encoding.  Use this option when dealing with those,
  203. er, MS-DOS machines.
  204.  
  205. UNIX - Uses standard uuencode technology.  This is the accepted
  206. standard on Usenet Newsgroups.  This is the default setting.
  207.  
  208. MAC - Uses the UNIX standard of encoding BUT uses the Macintosh
  209. filenaming convention (anything goes except ":").  This
  210. version of UUParser is not intended to be used for encoding of 
  211. applications, just documents and data files.  Therefore there is no
  212. guarantee that if you encode an app that you will be able to get
  213. it back (since UUParser ONLY encodes the data portion of files!).
  214.  
  215. AIFF->ULAW - Convert AIFF file to ULAW format (useful when
  216. transferring sounds to Sun or NeXT workstations.
  217.  
  218. AIFF->Linear - Convert AIFF file to Macintosh Linear format.
  219.  
  220. The OK button makes the changes for the session only.  No changes
  221. are saved to the prefs file. 
  222.  
  223. The SAVE button writes the changes to the prefs file.
  224.  
  225.  
  226. Special    
  227.  
  228. Scan Only
  229. The SCAN ONLY disables all parsing/decoding functionality and
  230. scans the files for non-printable characters.  If it finds 
  231. these characters it issues a warning with what it found.
  232.  
  233. Auto UUDecode
  234. This function allows automatic uudecoding of files that have been 
  235. parsed.  By default this option is ON.
  236.  
  237. While this function is enabled UUParsing & uudecoding occur
  238. in one pass.  The files are placed in your Target Directory
  239. (see below).
  240.  
  241. Set Target Directory
  242. NOTE:When using UUParser for the first time you MUST
  243. set the target directory.  This is where all your
  244. UUParsed files will go!  If it is not set, UUParser
  245. will put the files in it's home directory OR the desktop!
  246.  
  247. Set target directory lets UUParser know where to put your file
  248. once it has been parsed.  This is also handy because that directory
  249. will be the first one looked into when the Auto UUDecode option
  250. has been chosen.  Making the process of parsing/decoding
  251. truly one step and painless.
  252.  
  253.  
  254. Cold Mod Stuff    
  255.  
  256.  
  257. An abbreviated, but accurate history:
  258.  
  259. (Version 0.9)    Initial Coding
  260.  
  261. (Version 0.9b)  Added multiple-file parsing
  262.                         additional conditions for parsing
  263.  
  264. (Version 1.0)   Added faster parsing.  Better memory management
  265.                        parsing in memory.
  266.  
  267. (Version 1.1)   Added uudecoding w/ automatic 
  268.                        file type/creator setting.
  269.  
  270. (Version 1.1f)  Better error detection of files that have no "end" markers.
  271.                        Added Join Files capability.
  272.  
  273. (Version 1.2)   Added multiple-file drag-drop parsing functionality.
  274.                        Data errors are not reported on a byte/byte basis, 
  275.                        just once.
  276.                        Parsing process is speeded up ten-fold.  
  277.                        Operates on a 100k file in 1.5
  278.                        secs (as tested on a IIsi w/o math).
  279.                        uudecode speeded up. 
  280.                        Create versions of UUParser for each type of platform:
  281.                       1.2  -> for all macs 68000 and up
  282.                       1.2(020) -> for macs w 68020/68030/68040 w/o math co.
  283.                       1.2(020/881) -> all macs w/ 020/030/040 & math co.
  284.  
  285. (Version 1.3)  Added uuengine technology.  Background processing
  286.                       when uudecoding.  UUdecode/encode window is now movable.
  287.                       Have the option of continuing when disk errors occurs.
  288.                       (previously it exited the program!).
  289.                       Can now select target directory for uudecoded files.
  290.  
  291. (Version 1.5)  Added configurable uuencoding, smart uudecoding,
  292.                       selection of automatic type/creator, splitting of files,
  293.                       selection of encoding scheme from menu, setting of
  294.                       target directory for UUParsed files, multiple file selection
  295.                       when decoding.  Auto-Decode automatically set to "ON". 
  296.                       Universal code now compatible with ALL Macintoshes
  297.                       (running sys 7).
  298.  
  299. (Version 1.7)  Better memory management.  UUParser can parse large
  300.                       files regardless of the amount of memory available to
  301.                       the application.  UUParser can parse in the background.
  302.                       UUParser now notifies you when parsing has completed
  303.                       (when running in the background).  You can have UUParser
  304.                       rename the files in upper case.  During Drag & Drop,
  305.                       if you hold down the COMMAND key, UUParser will automatically
  306.                       Join the files for you. 
  307.  
  308. (Version 1.71) Allows parsing of files irregardless of amount of memory.
  309.                        Decreased the allocated memory size to 384k.
  310.  
  311. (Version 1.72) First registered users version.  Removed memory restrictions
  312.                        for joining.  Fixed file locking problem during abort.
  313.  
  314.  
  315.  
  316. UUParser Internals & Notes    
  317.  
  318.  
  319. UUParser stores the preferences info in the UUP Prefs file
  320. in the Preferences folder in your System Folder.  The Prefs
  321. consists of UUParser parsing options, encoding prefs, 
  322. and target directory info.  The file suffix parms that make UUParser
  323. "smart" are stored in the AtTr & STR# resources.  Because
  324. UUParser makes certain assumtions about these files you should
  325. not change them directly!  If you do UUParser will not work properly
  326. or at all.  If you have to make changes, use UUParser's Preferences
  327. from the File menu to do so!
  328.  
  329. If you have a previous version of UUParser (0.9-1.2) you may get a
  330. disk error when the program is started.  This is becuase the Prefs file
  331. format is different in 1.7 than in previous versions.  Dont worry. 
  332. Just hit the continue button, set up your preferences, choose
  333. a target directory and the problem will be corrected (be sure to
  334. SAVE your prefs).
  335.  
  336. I wanted to make UUParser useful for systems 6 & 7.  Since
  337. system 7 has so many nicetites when it comes to file handling
  338. I decided that version 1.7 and up would be reliant on system 7 for
  339. proper usage.  Some items may not work properly if you are not
  340. using system 7.
  341.  
  342. The "use 20 times and pay" policy was my idea of fair.  
  343. Most shareware programs have a 30 days policy, 
  344. but I figured that after a certain amount of uses you would get a
  345. good idea as to UUParsers worth.  20 was the number I came up with.
  346. Why did I mention this?  To once again encourage you to use it, and pay
  347. for it once you have used it 20 times.  There will be upgrades and
  348. additions that you will get ONLY if you are registered.
  349.  
  350.  
  351.  
  352. Upgrades    
  353.  
  354. To keep things simple, cheap, and virtual, I will e-mail all upgrades
  355. to UUParser's registered owners.  If you prefer a copy mailed to
  356. you, send a self-adressed-stamped-envelope and a blank disk +
  357. $5 for p&h and my time (you only have to do this once.  After that
  358. just mail the disk BACK to me and I'll send you the latest version.  I'll
  359. cover the return postage). 
  360.  
  361. As soon as I get the mailer, I will send it back with the latest
  362. version.  I will also notify you of any changes and future upgrades
  363. via e-mail so make sure you indicate your e-mail address so
  364. I can put you on the list.
  365.  
  366. If you are not registered there are two options:
  367. Send in the $10 registration fee.  I will e-mail you the latest version.
  368.                                        or
  369. Send in $15 as the registration fee.  I  will mail you a copy of the
  370. latest version on disk.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382. Future Additions    
  383.  
  384.  
  385. UUParser was originally designed to do one thing, parse files.
  386. Now it has many features and additions that extends that basic
  387. philosophy.  It is now a full fledged uudecoder/uuencoder, file
  388. splitter, and text file verifier.  But the fans, and registered
  389. users of UUParser have asked for even more, and I am more than
  390. happy to include these additions for UUParser users.   The next major
  391. release will be 2.0.  There may  be intermediate versions until 2.0, but
  392. these will concentrate on mods to version 1.5 technology.  
  393. Version 2.0 will be avaialble to registered users only.
  394.  
  395. Version 2.0 will include:
  396. ‚Ä¢Control over the parameters of file splitting.
  397. ‚Ä¢Control over parsing parameters.
  398. ‚Ä¢A more versatile join function.
  399. ‚Ä¢Encode/decode Mac apps.
  400. ‚Ä¢Binhex encode/decode, along with parsing
  401.   files that have been binhex'ed and sent to newsgroups.
  402. ‚Ä¢Preview of gif, jpeg files.
  403.  
  404. ...and LOTS more! 
  405.  
  406.  
  407.  
  408. Hints    
  409.  
  410.  
  411. ‚Ä¢ To save time if you have multiple files "Join" them into one file,
  412. then parse the joined file.  If Auto-UUDecode is on ALL of the files
  413. will be decoded and placed in your Target Directory. Make sure
  414. you allocate enough memory for this operation.
  415.  
  416. ‚Ä¢ If you get -1 disk errors while decoding it means that the 
  417. file is corrupt.  Some people have trouble sending files to 
  418. newsgroups.  You can attempt to fix the file with a text editor
  419. or try another file.
  420.  
  421. ‚Ä¢ Disk errors that occur when the program is loading are most
  422. likely due to an error UUP Prefs file.  You should be able to continue.
  423. Reset your preferences, set your target directory, and save the
  424. changes.  This will correct the file.  If it does not work, delete the
  425. prefs file and re-start UUParser (the file is in "System Folder:
  426. Preferences:UUP Prefs").
  427.  
  428. ‚Ä¢ If you get disk errors while UUParsing or uudecoding they are
  429. most likely due to the target directory not being set.  Remember
  430. to set up your Target Directory when you use UUParser for the
  431. first time.  The changes are saved to the preferences file.
  432.  
  433. ‚Ä¢ Some people do not put cut lines in their files.  Instead they
  434. use line breaks, or worse yet, blank lines.  There really is no
  435. universal rule about posting to a newgroup.  If you have problems
  436. with a file check it out with a text editor, delete the offending lines,
  437. UUParse the file again,and re-attempt decoding.  If this does not
  438. work the file is probably bad.
  439.  
  440. ‚Ä¢ Remember when Joining, the files must be in the right
  441. order if you are planning to parse/decode them.  Take great
  442. care in the join process.
  443.  
  444. ‚Ä¢ I am always looking for ways to improve this product.  If you
  445. have any ideas as to what you'd like to see UUParser do,
  446. that it does currently not do, or just changes you'd like to see,
  447. don't be shy.  E-mail me with your suggestion.  I will get back to you
  448. as I am very attentive, caring, and most of all verbose  :-)
  449.  
  450.  
  451.  
  452. Registration    
  453.  
  454. UUParser is SHAREWARE.  Use it 20 times.  If you like it register it
  455. by sending $10.00 (US funds) to:
  456.  
  457. John S. Lee
  458. 1600 Fell St. #210
  459. San Francisco, CA. 94117
  460.  
  461. e-mail (for bug reports, enhancement requests, and questions):
  462. Internet->   jsl@netcom.com
  463.  
  464. By registering you are entitled to updates of UUParser
  465. as they become available.
  466.  
  467. This HELP document does not replace the documentation.  
  468. Reference it for additional technical 
  469.  information about UUParser.
  470.  
  471. THANKS for using UUParser :)
  472.  
  473.  
  474. Credits    
  475.  
  476.  
  477. Programming/Design: John S. Lee
  478.  
  479. Testing                     : Mike Baranowski & Brian K. Tanaka
  480.  
  481. Support                    : Arlene G. Lee & Sultan I. Lee
  482.  
  483. uu-engine software   : B. Wieser & Octavian Micro Development
  484.  
  485. Documentation          : Mike Baranowski & John S. Lee
  486.  
  487. uudecode info            : Peter Honeyman, Robert Perlberg, and Tim Rose
  488.  
  489. Help Dialog Utility     : James W. Walker
  490.  
  491. Special Props           : Brian K. Tanaka for the ever consistent
  492.                                  "You know, it would be even better if..." &
  493.                                  "You know what you oughta add is..."
  494.  
  495.                                  Mike Baranowski for the ever present
  496.                                  "Is there a way of..." & "...can you add this
  497.                                    one other mod...".
  498.  
  499.                                  B. Wieser for user interface suggestions. 
  500.  
  501.                                  To ALL of them for the many ideas that makes
  502.                                  UUParser useful and fun to use.
  503.  
  504.  
  505. uu-engine Copyright 1991 by B. Wieser and Octavian Micro Development.
  506. Macintosh‚Ñ¢ is a registered trademark of Apple Computer, Inc.
  507. UNIX‚Ñ¢ is a registered trademark of AT&T Information Systems.
  508.  
  509. Legal note:  Use the software at your own risk.  I am not responsible for
  510. lost data.  The program has been tested as best it could be.  I make no other
  511. warranties, either expressed or implied.
  512.  
  513. UUParser is Copyright 1993,1994 by John S. Lee & Truly Mac, Inc.
  514. All Rights Reserved.
  515.  
  516.     
  517.